<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GMimeObject: GMime 3.0 Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<link rel="home" href="index.html" title="GMime 3.0 Reference Manual">
<link rel="up" href="MimeParts.html" title="MIME Messages and Parts">
<link rel="prev" href="MimeParts.html" title="MIME Messages and Parts">
<link rel="next" href="GMimeMessage.html" title="GMimeMessage">
<meta name="generator" content="GTK-Doc V1.32 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
                  <a href="#GMimeObject.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
                  <a href="#GMimeObject.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="MimeParts.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="MimeParts.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="GMimeMessage.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="GMimeObject"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GMimeObject.top_of_page"></a>GMimeObject</span></h2>
<p>GMimeObject — Abstract MIME objects</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="GMimeObject.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_proto_type">
<col class="functions_proto_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<span class="c_punctuation">(</span><a class="link" href="GMimeObject.html#GMimeObjectForeachFunc" title="GMimeObjectForeachFunc ()">*GMimeObjectForeachFunc</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-register-type" title="g_mime_object_register_type ()">g_mime_object_register_type</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GMimeObject.html" title="GMimeObject"><span class="returnvalue">GMimeObject</span></a> *
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-new" title="g_mime_object_new ()">g_mime_object_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GMimeObject.html" title="GMimeObject"><span class="returnvalue">GMimeObject</span></a> *
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-new-type" title="g_mime_object_new_type ()">g_mime_object_new_type</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-set-content-type" title="g_mime_object_set_content_type ()">g_mime_object_set_content_type</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GMimeContentType.html" title="GMimeContentType"><span class="returnvalue">GMimeContentType</span></a> *
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-get-content-type" title="g_mime_object_get_content_type ()">g_mime_object_get_content_type</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-set-content-type-parameter" title="g_mime_object_set_content_type_parameter ()">g_mime_object_set_content_type_parameter</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">char</span> *
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-get-content-type-parameter" title="g_mime_object_get_content_type_parameter ()">g_mime_object_get_content_type_parameter</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-set-disposition" title="g_mime_object_set_disposition ()">g_mime_object_set_disposition</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">char</span> *
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-get-disposition" title="g_mime_object_get_disposition ()">g_mime_object_get_disposition</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-set-content-disposition" title="g_mime_object_set_content_disposition ()">g_mime_object_set_content_disposition</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GMimeContentDisposition.html" title="GMimeContentDisposition"><span class="returnvalue">GMimeContentDisposition</span></a> *
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-get-content-disposition" title="g_mime_object_get_content_disposition ()">g_mime_object_get_content_disposition</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-set-content-disposition-parameter" title="g_mime_object_set_content_disposition_parameter ()">g_mime_object_set_content_disposition_parameter</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">char</span> *
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-get-content-disposition-parameter" title="g_mime_object_get_content_disposition_parameter ()">g_mime_object_get_content_disposition_parameter</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-set-content-id" title="g_mime_object_set_content_id ()">g_mime_object_set_content_id</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">char</span> *
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-get-content-id" title="g_mime_object_get_content_id ()">g_mime_object_get_content_id</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-prepend-header" title="g_mime_object_prepend_header ()">g_mime_object_prepend_header</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-append-header" title="g_mime_object_append_header ()">g_mime_object_append_header</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-remove-header" title="g_mime_object_remove_header ()">g_mime_object_remove_header</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-set-header" title="g_mime_object_set_header ()">g_mime_object_set_header</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">char</span> *
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-get-header" title="g_mime_object_get_header ()">g_mime_object_get_header</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">char</span> *
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-get-headers" title="g_mime_object_get_headers ()">g_mime_object_get_headers</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GMimeHeaderList.html" title="GMimeHeaderList"><span class="returnvalue">GMimeHeaderList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-get-header-list" title="g_mime_object_get_header_list ()">g_mime_object_get_header_list</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">ssize_t</span>
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-write-to-stream" title="g_mime_object_write_to_stream ()">g_mime_object_write_to_stream</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">char</span> *
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-to-string" title="g_mime_object_to_string ()">g_mime_object_to_string</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GMimeObject.html#g-mime-object-encode" title="g_mime_object_encode ()">g_mime_object_encode</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GMimeObject.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="other_proto_type">
<col class="other_proto_name">
</colgroup>
<tbody><tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="GMimeObject.html#GMimeObject-struct" title="struct GMimeObject">GMimeObject</a></td>
</tr></tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GMimeObject.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen">    GObject
    <span class="lineart">╰──</span> GMimeObject
        <span class="lineart">├──</span> <a class="link" href="GMimeMessage.html" title="GMimeMessage">GMimeMessage</a>
        <span class="lineart">├──</span> <a class="link" href="GMimePart.html" title="GMimePart">GMimePart</a>
        <span class="lineart">├──</span> <a class="link" href="GMimeMultipart.html" title="GMimeMultipart">GMimeMultipart</a>
        <span class="lineart">╰──</span> <a class="link" href="GMimeMessagePart.html" title="GMimeMessagePart">GMimeMessagePart</a>
</pre>
</div>
<div class="refsect1">
<a name="GMimeObject.description"></a><h2>Description</h2>
<p><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> is an abstract class from which all message and MIME
parts are derived.</p>
</div>
<div class="refsect1">
<a name="GMimeObject.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="GMimeObjectForeachFunc"></a><h3>GMimeObjectForeachFunc ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
<span class="c_punctuation">(</span>*GMimeObjectForeachFunc<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *parent</code></em>,
                           <em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *part</code></em>,
                           <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<p>The function signature for a callback to <a class="link" href="GMimeMessage.html#g-mime-message-foreach" title="g_mime_message_foreach ()"><code class="function">g_mime_message_foreach()</code></a>
and <a class="link" href="GMimeMultipart.html#g-mime-multipart-foreach" title="g_mime_multipart_foreach ()"><code class="function">g_mime_multipart_foreach()</code></a>.</p>
<div class="refsect3">
<a name="GMimeObjectForeachFunc.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>parent</p></td>
<td class="parameter_description"><p>parent <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>part</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>User-supplied callback data.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-register-type"></a><h3>g_mime_object_register_type ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
g_mime_object_register_type (<em class="parameter"><code>const <span class="type">char</span> *type</code></em>,
                             <em class="parameter"><code>const <span class="type">char</span> *subtype</code></em>,
                             <em class="parameter"><code><span class="type">GType</span> object_type</code></em>);</pre>
<p>Registers the object type <em class="parameter"><code>object_type</code></em>
 for use with the
<a class="link" href="GMimeObject.html#g-mime-object-new-type" title="g_mime_object_new_type ()"><code class="function">g_mime_object_new_type()</code></a> convenience function.</p>
<p>Note: You may use the wildcard "*" to match any type and/or
subtype.</p>
<div class="refsect3">
<a name="g-mime-object-register-type.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>type</p></td>
<td class="parameter_description"><p>mime type</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>subtype</p></td>
<td class="parameter_description"><p>mime subtype</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>object_type</p></td>
<td class="parameter_description"><p>object type</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-new"></a><h3>g_mime_object_new ()</h3>
<pre class="programlisting"><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="returnvalue">GMimeObject</span></a> *
g_mime_object_new (<em class="parameter"><code><a class="link" href="gmime-GMimeParserOptions.html#GMimeParserOptions" title="GMimeParserOptions"><span class="type">GMimeParserOptions</span></a> *options</code></em>,
                   <em class="parameter"><code><a class="link" href="GMimeContentType.html" title="GMimeContentType"><span class="type">GMimeContentType</span></a> *content_type</code></em>);</pre>
<p>Performs a lookup of registered <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> subclasses, registered
using <a class="link" href="GMimeObject.html#g-mime-object-register-type" title="g_mime_object_register_type ()"><code class="function">g_mime_object_register_type()</code></a>, to find an appropriate class
capable of handling MIME parts of the specified Content-Type. If no
class has been registered to handle that type, it looks for a
registered class that can handle <em class="parameter"><code>content_type</code></em>
's media type. If
that also fails, then it will use the generic part class,
<a class="link" href="GMimePart.html" title="GMimePart"><span class="type">GMimePart</span></a>.</p>
<div class="refsect3">
<a name="g-mime-object-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>options</p></td>
<td class="parameter_description"><p>a <a class="link" href="gmime-GMimeParserOptions.html#GMimeParserOptions" title="GMimeParserOptions"><span class="type">GMimeParserOptions</span></a> or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/nullable"><span class="acronym">nullable</span></a>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>content_type</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeContentType.html" title="GMimeContentType"><span class="type">GMimeContentType</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="g-mime-object-new.returns"></a><h4>Returns</h4>
<p> an appropriate <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> registered to handle MIME
parts appropriate for <em class="parameter"><code>content_type</code></em>
.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-new-type"></a><h3>g_mime_object_new_type ()</h3>
<pre class="programlisting"><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="returnvalue">GMimeObject</span></a> *
g_mime_object_new_type (<em class="parameter"><code><a class="link" href="gmime-GMimeParserOptions.html#GMimeParserOptions" title="GMimeParserOptions"><span class="type">GMimeParserOptions</span></a> *options</code></em>,
                        <em class="parameter"><code>const <span class="type">char</span> *type</code></em>,
                        <em class="parameter"><code>const <span class="type">char</span> *subtype</code></em>);</pre>
<p>Performs a lookup of registered <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> subclasses, registered
using <a class="link" href="GMimeObject.html#g-mime-object-register-type" title="g_mime_object_register_type ()"><code class="function">g_mime_object_register_type()</code></a>, to find an appropriate class
capable of handling MIME parts of type <em class="parameter"><code>type</code></em>
/<em class="parameter"><code>subtype</code></em>
. If no class
has been registered to handle that type, it looks for a registered
class that can handle <em class="parameter"><code>type</code></em>
. If that also fails, then it will use
the generic part class, <a class="link" href="GMimePart.html" title="GMimePart"><span class="type">GMimePart</span></a>.</p>
<div class="refsect3">
<a name="g-mime-object-new-type.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>options</p></td>
<td class="parameter_description"><p>a <a class="link" href="gmime-GMimeParserOptions.html#GMimeParserOptions" title="GMimeParserOptions"><span class="type">GMimeParserOptions</span></a> or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/nullable"><span class="acronym">nullable</span></a>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>type</p></td>
<td class="parameter_description"><p>mime type</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>subtype</p></td>
<td class="parameter_description"><p>mime subtype</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="g-mime-object-new-type.returns"></a><h4>Returns</h4>
<p> an appropriate <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> registered to handle mime-types
of <em class="parameter"><code>type</code></em>
/<em class="parameter"><code>subtype</code></em>
.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-set-content-type"></a><h3>g_mime_object_set_content_type ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
g_mime_object_set_content_type (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>,
                                <em class="parameter"><code><a class="link" href="GMimeContentType.html" title="GMimeContentType"><span class="type">GMimeContentType</span></a> *content_type</code></em>);</pre>
<p>Sets the content-type for the specified MIME object and then
serializes it to the Content-Type header field.</p>
<div class="refsect3">
<a name="g-mime-object-set-content-type.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>content_type</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeContentType.html" title="GMimeContentType"><span class="type">GMimeContentType</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-get-content-type"></a><h3>g_mime_object_get_content_type ()</h3>
<pre class="programlisting"><a class="link" href="GMimeContentType.html" title="GMimeContentType"><span class="returnvalue">GMimeContentType</span></a> *
g_mime_object_get_content_type (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>);</pre>
<p>Gets the <a class="link" href="GMimeContentType.html" title="GMimeContentType"><span class="type">GMimeContentType</span></a> object for the given MIME object or
<code class="literal">NULL</code> on fail.</p>
<div class="refsect3">
<a name="g-mime-object-get-content-type.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="g-mime-object-get-content-type.returns"></a><h4>Returns</h4>
<p>the content-type object for the specified
MIME object. </p>
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20none"><span class="acronym">transfer none</span></a>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-set-content-type-parameter"></a><h3>g_mime_object_set_content_type_parameter ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
g_mime_object_set_content_type_parameter
                               (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>,
                                <em class="parameter"><code>const <span class="type">char</span> *name</code></em>,
                                <em class="parameter"><code>const <span class="type">char</span> *value</code></em>);</pre>
<p>Sets the content-type param <em class="parameter"><code>name</code></em>
 to the value <em class="parameter"><code>value</code></em>
.</p>
<p>Note: The <em class="parameter"><code>name</code></em>
 string should be in US-ASCII while the <em class="parameter"><code>value</code></em>

string should be in UTF-8.</p>
<div class="refsect3">
<a name="g-mime-object-set-content-type-parameter.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>param name</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>param value</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-get-content-type-parameter"></a><h3>g_mime_object_get_content_type_parameter ()</h3>
<pre class="programlisting">const <span class="returnvalue">char</span> *
g_mime_object_get_content_type_parameter
                               (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>,
                                <em class="parameter"><code>const <span class="type">char</span> *name</code></em>);</pre>
<p>Gets the value of the content-type param <em class="parameter"><code>name</code></em>
 set on the MIME part
<em class="parameter"><code>object</code></em>
.</p>
<div class="refsect3">
<a name="g-mime-object-get-content-type-parameter.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>param name</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="g-mime-object-get-content-type-parameter.returns"></a><h4>Returns</h4>
<p> the value of the requested content-type param or <code class="literal">NULL</code> if
the param doesn't exist. If the param is set, the returned string
will be in UTF-8.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-set-disposition"></a><h3>g_mime_object_set_disposition ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
g_mime_object_set_disposition (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>,
                               <em class="parameter"><code>const <span class="type">char</span> *disposition</code></em>);</pre>
<p>Sets the disposition to <em class="parameter"><code>disposition</code></em>
 which may be one of
<a class="link" href="GMimeContentDisposition.html#GMIME-DISPOSITION-ATTACHMENT:CAPS" title="GMIME_DISPOSITION_ATTACHMENT"><span class="type">GMIME_DISPOSITION_ATTACHMENT</span></a> or <a class="link" href="GMimeContentDisposition.html#GMIME-DISPOSITION-INLINE:CAPS" title="GMIME_DISPOSITION_INLINE"><span class="type">GMIME_DISPOSITION_INLINE</span></a> or, by
your choice, any other string which would indicate how the MIME
part should be displayed by the MUA.</p>
<div class="refsect3">
<a name="g-mime-object-set-disposition.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>disposition</p></td>
<td class="parameter_description"><p>disposition ("attachment" or "inline")</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-get-disposition"></a><h3>g_mime_object_get_disposition ()</h3>
<pre class="programlisting">const <span class="returnvalue">char</span> *
g_mime_object_get_disposition (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>);</pre>
<p>Gets the MIME object's disposition if set or <code class="literal">NULL</code> otherwise.</p>
<div class="refsect3">
<a name="g-mime-object-get-disposition.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="g-mime-object-get-disposition.returns"></a><h4>Returns</h4>
<p> the disposition string which is probably one of
<a class="link" href="GMimeContentDisposition.html#GMIME-DISPOSITION-ATTACHMENT:CAPS" title="GMIME_DISPOSITION_ATTACHMENT"><span class="type">GMIME_DISPOSITION_ATTACHMENT</span></a> or <a class="link" href="GMimeContentDisposition.html#GMIME-DISPOSITION-INLINE:CAPS" title="GMIME_DISPOSITION_INLINE"><span class="type">GMIME_DISPOSITION_INLINE</span></a>.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-set-content-disposition"></a><h3>g_mime_object_set_content_disposition ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
g_mime_object_set_content_disposition (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>,
                                       <em class="parameter"><code><a class="link" href="GMimeContentDisposition.html" title="GMimeContentDisposition"><span class="type">GMimeContentDisposition</span></a> *disposition</code></em>);</pre>
<p>Set the content disposition for the specified mime part and then
serializes it to the Content-Disposition header field.</p>
<div class="refsect3">
<a name="g-mime-object-set-content-disposition.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>disposition</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeContentDisposition.html" title="GMimeContentDisposition"><span class="type">GMimeContentDisposition</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-get-content-disposition"></a><h3>g_mime_object_get_content_disposition ()</h3>
<pre class="programlisting"><a class="link" href="GMimeContentDisposition.html" title="GMimeContentDisposition"><span class="returnvalue">GMimeContentDisposition</span></a> *
g_mime_object_get_content_disposition (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>);</pre>
<p>Gets the <a class="link" href="GMimeContentDisposition.html" title="GMimeContentDisposition"><span class="type">GMimeContentDisposition</span></a> for the specified MIME object.</p>
<div class="refsect3">
<a name="g-mime-object-get-content-disposition.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="g-mime-object-get-content-disposition.returns"></a><h4>Returns</h4>
<p>the <a class="link" href="GMimeContentDisposition.html" title="GMimeContentDisposition"><span class="type">GMimeContentDisposition</span></a> set on the
MIME object. </p>
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20none"><span class="acronym">transfer none</span></a>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-set-content-disposition-parameter"></a><h3>g_mime_object_set_content_disposition_parameter ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
g_mime_object_set_content_disposition_parameter
                               (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>,
                                <em class="parameter"><code>const <span class="type">char</span> *name</code></em>,
                                <em class="parameter"><code>const <span class="type">char</span> *value</code></em>);</pre>
<p>Add a content-disposition parameter to the specified mime part.</p>
<p>Note: The <em class="parameter"><code>name</code></em>
 string should be in US-ASCII while the <em class="parameter"><code>value</code></em>

string should be in UTF-8.</p>
<div class="refsect3">
<a name="g-mime-object-set-content-disposition-parameter.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>parameter name</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>parameter value</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-get-content-disposition-parameter"></a><h3>g_mime_object_get_content_disposition_parameter ()</h3>
<pre class="programlisting">const <span class="returnvalue">char</span> *
g_mime_object_get_content_disposition_parameter
                               (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>,
                                <em class="parameter"><code>const <span class="type">char</span> *name</code></em>);</pre>
<p>Gets the value of the Content-Disposition parameter specified by
<em class="parameter"><code>name</code></em>
, or <code class="literal">NULL</code> if the parameter does not exist.</p>
<div class="refsect3">
<a name="g-mime-object-get-content-disposition-parameter.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>parameter name</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="g-mime-object-get-content-disposition-parameter.returns"></a><h4>Returns</h4>
<p> the value of the requested content-disposition param or
<code class="literal">NULL</code> if the param doesn't exist. If the param is set, the returned
string will be in UTF-8.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-set-content-id"></a><h3>g_mime_object_set_content_id ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
g_mime_object_set_content_id (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>,
                              <em class="parameter"><code>const <span class="type">char</span> *content_id</code></em>);</pre>
<p>Sets the Content-Id of the MIME object.</p>
<div class="refsect3">
<a name="g-mime-object-set-content-id.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>content_id</p></td>
<td class="parameter_description"><p>content-id (addr-spec portion)</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-get-content-id"></a><h3>g_mime_object_get_content_id ()</h3>
<pre class="programlisting">const <span class="returnvalue">char</span> *
g_mime_object_get_content_id (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>);</pre>
<p>Gets the Content-Id of the MIME object or NULL if one is not set.</p>
<div class="refsect3">
<a name="g-mime-object-get-content-id.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="g-mime-object-get-content-id.returns"></a><h4>Returns</h4>
<p> a const pointer to the Content-Id header.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-prepend-header"></a><h3>g_mime_object_prepend_header ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
g_mime_object_prepend_header (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>,
                              <em class="parameter"><code>const <span class="type">char</span> *header</code></em>,
                              <em class="parameter"><code>const <span class="type">char</span> *value</code></em>,
                              <em class="parameter"><code>const <span class="type">char</span> *charset</code></em>);</pre>
<p>Prepends a new header to the header list.</p>
<div class="refsect3">
<a name="g-mime-object-prepend-header.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>header</p></td>
<td class="parameter_description"><p>header name</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>header value</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>charset</p></td>
<td class="parameter_description"><p>a charset</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-append-header"></a><h3>g_mime_object_append_header ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
g_mime_object_append_header (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>,
                             <em class="parameter"><code>const <span class="type">char</span> *header</code></em>,
                             <em class="parameter"><code>const <span class="type">char</span> *value</code></em>,
                             <em class="parameter"><code>const <span class="type">char</span> *charset</code></em>);</pre>
<p>Appends a new header to the header list.</p>
<div class="refsect3">
<a name="g-mime-object-append-header.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>header</p></td>
<td class="parameter_description"><p>header name</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>header value</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>charset</p></td>
<td class="parameter_description"><p>a charset</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-remove-header"></a><h3>g_mime_object_remove_header ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
g_mime_object_remove_header (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>,
                             <em class="parameter"><code>const <span class="type">char</span> *header</code></em>);</pre>
<p>Removed the specified header if it exists.</p>
<div class="refsect3">
<a name="g-mime-object-remove-header.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>header</p></td>
<td class="parameter_description"><p>header name</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="g-mime-object-remove-header.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the header was removed or <code class="literal">FALSE</code> if it could not
be found.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-set-header"></a><h3>g_mime_object_set_header ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
g_mime_object_set_header (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>,
                          <em class="parameter"><code>const <span class="type">char</span> *header</code></em>,
                          <em class="parameter"><code>const <span class="type">char</span> *value</code></em>,
                          <em class="parameter"><code>const <span class="type">char</span> *charset</code></em>);</pre>
<p>Sets a header to the specified value.</p>
<div class="refsect3">
<a name="g-mime-object-set-header.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>header</p></td>
<td class="parameter_description"><p>header name</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>header value</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>charset</p></td>
<td class="parameter_description"><p>a charset</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-get-header"></a><h3>g_mime_object_get_header ()</h3>
<pre class="programlisting">const <span class="returnvalue">char</span> *
g_mime_object_get_header (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>,
                          <em class="parameter"><code>const <span class="type">char</span> *header</code></em>);</pre>
<p>Gets the value of the first header with the specified name.</p>
<div class="refsect3">
<a name="g-mime-object-get-header.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>header</p></td>
<td class="parameter_description"><p>header name</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="g-mime-object-get-header.returns"></a><h4>Returns</h4>
<p> the value of the requested header if it
exists or <code class="literal">NULL</code> otherwise.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-get-headers"></a><h3>g_mime_object_get_headers ()</h3>
<pre class="programlisting"><span class="returnvalue">char</span> *
g_mime_object_get_headers (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>,
                           <em class="parameter"><code><a class="link" href="gmime-GMimeFormatOptions.html#GMimeFormatOptions" title="GMimeFormatOptions"><span class="type">GMimeFormatOptions</span></a> *options</code></em>);</pre>
<p>Allocates a string buffer containing all of the MIME object's raw
headers.</p>
<div class="refsect3">
<a name="g-mime-object-get-headers.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>options</p></td>
<td class="parameter_description"><p>a <a class="link" href="gmime-GMimeFormatOptions.html#GMimeFormatOptions" title="GMimeFormatOptions"><span class="type">GMimeFormatOptions</span></a> or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/nullable"><span class="acronym">nullable</span></a>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="g-mime-object-get-headers.returns"></a><h4>Returns</h4>
<p> an allocated string containing all of the raw MIME headers.</p>
<p>Note: The returned string will not be suitable for display.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-get-header-list"></a><h3>g_mime_object_get_header_list ()</h3>
<pre class="programlisting"><a class="link" href="GMimeHeaderList.html" title="GMimeHeaderList"><span class="returnvalue">GMimeHeaderList</span></a> *
g_mime_object_get_header_list (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>);</pre>
<p>Get the header list for <em class="parameter"><code>object</code></em>
.</p>
<div class="refsect3">
<a name="g-mime-object-get-header-list.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="g-mime-object-get-header-list.returns"></a><h4>Returns</h4>
<p>the <a class="link" href="GMimeHeaderList.html" title="GMimeHeaderList"><span class="type">GMimeHeaderList</span></a> for <em class="parameter"><code>object</code></em>
. Do not
free this pointer when you are done with it. </p>
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20none"><span class="acronym">transfer none</span></a>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-write-to-stream"></a><h3>g_mime_object_write_to_stream ()</h3>
<pre class="programlisting"><span class="returnvalue">ssize_t</span>
g_mime_object_write_to_stream (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>,
                               <em class="parameter"><code><a class="link" href="gmime-GMimeFormatOptions.html#GMimeFormatOptions" title="GMimeFormatOptions"><span class="type">GMimeFormatOptions</span></a> *options</code></em>,
                               <em class="parameter"><code><a class="link" href="GMimeStream.html" title="GMimeStream"><span class="type">GMimeStream</span></a> *stream</code></em>);</pre>
<p>Write the contents of the MIME object to <em class="parameter"><code>stream</code></em>
.</p>
<div class="refsect3">
<a name="g-mime-object-write-to-stream.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>options</p></td>
<td class="parameter_description"><p>a <a class="link" href="gmime-GMimeFormatOptions.html#GMimeFormatOptions" title="GMimeFormatOptions"><span class="type">GMimeFormatOptions</span></a> or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/nullable"><span class="acronym">nullable</span></a>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>stream</p></td>
<td class="parameter_description"><p>stream</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="g-mime-object-write-to-stream.returns"></a><h4>Returns</h4>
<p> the number of bytes written or <code class="literal">-1</code> on fail.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-to-string"></a><h3>g_mime_object_to_string ()</h3>
<pre class="programlisting"><span class="returnvalue">char</span> *
g_mime_object_to_string (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>,
                         <em class="parameter"><code><a class="link" href="gmime-GMimeFormatOptions.html#GMimeFormatOptions" title="GMimeFormatOptions"><span class="type">GMimeFormatOptions</span></a> *options</code></em>);</pre>
<p>Allocates a string buffer containing the contents of <em class="parameter"><code>object</code></em>
.</p>
<div class="refsect3">
<a name="g-mime-object-to-string.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>options</p></td>
<td class="parameter_description"><p>a <a class="link" href="gmime-GMimeFormatOptions.html#GMimeFormatOptions" title="GMimeFormatOptions"><span class="type">GMimeFormatOptions</span></a> or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/nullable"><span class="acronym">nullable</span></a>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="g-mime-object-to-string.returns"></a><h4>Returns</h4>
<p> an allocated string containing the contents of the mime
object.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="g-mime-object-encode"></a><h3>g_mime_object_encode ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
g_mime_object_encode (<em class="parameter"><code><a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> *object</code></em>,
                      <em class="parameter"><code><a class="link" href="gmime-gmime-encodings.html#GMimeEncodingConstraint" title="enum GMimeEncodingConstraint"><span class="type">GMimeEncodingConstraint</span></a> constraint</code></em>);</pre>
<p>Calculates and sets the most efficient Content-Transfer-Encoding
for this <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a> and all child parts based on the <em class="parameter"><code>constraint</code></em>

provided.</p>
<div class="refsect3">
<a name="g-mime-object-encode.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <a class="link" href="GMimeObject.html" title="GMimeObject"><span class="type">GMimeObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>constraint</p></td>
<td class="parameter_description"><p>a <a class="link" href="gmime-gmime-encodings.html#GMimeEncodingConstraint" title="enum GMimeEncodingConstraint"><span class="type">GMimeEncodingConstraint</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="refsect1">
<a name="GMimeObject.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GMimeObject-struct"></a><h3>struct GMimeObject</h3>
<pre class="programlisting">struct GMimeObject;</pre>
<p>Base class for all MIME parts.</p>
<div class="refsect3">
<a name="GMimeObject.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody></tbody>
</table></div>
</div>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.32</div>
</body>
</html>